Stiamo aggiornando l'API Data in modo che corrisponda al modo in cui YouTube conteggia le visualizzazioni di Shorts.
Scopri di più
MembershipsLevels: list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Nota: questo endpoint può essere utilizzato solo dai singoli creator per effettuare richieste per il proprio canale YouTube in cui sono abilitati gli abbonamenti al canale. Contatta il tuo rappresentante di Google o YouTube per richiedere l'accesso.
Elenca i livelli di abbonamento del canale che ha autorizzato la richiesta. I livelli vengono restituiti in
ordine di visualizzazione implicito. Le richieste API a questo metodo restituiscono una delle seguenti risposte:
- Se il creator ha attivato gli abbonamenti al canale e prevede livelli di prezzo, la risposta dell'API contiene l'elenco dei livelli.
- Se il creator ha attivato gli abbonamenti al canale, ma non ha definito i livelli di prezzo, la risposta dell'API conterrà un elenco vuoto.
- Se il creator non ha attivato gli abbonamenti al canale, l'API restituisce un
errore
channelMembershipsNotEnabled.
Impatto della quota: una chiamata a questo metodo ha un
costo della quota di 1 unità.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/youtube/v3/membershipsLevels
Questa richiesta richiede l'autorizzazione con il seguente ambito:
| Ambito |
|---|
https://www.googleapis.com/auth/youtube.channel-memberships.creator |
Parametri
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
| Parametri |
| Parametri obbligatori |
part |
string
Il parametro part specifica le proprietà della risorsa membershipsLevel
che saranno incluse nella risposta dell'API. Il valore del parametro è un elenco separato da virgole di parti di risorse. Il seguente elenco mostra le parti che possono
essere recuperate:
|
Corpo della richiesta
Non fornire il corpo della richiesta quando chiami questo metodo.
Risposta
Se l'esito è positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"kind": "youtube#membershipsLevelListResponse",
"etag": etag,
"items": [
membershipsLevel Resource
]
}
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
| Proprietà |
kind |
string
Identifica il tipo di risorsa API. Il valore sarà youtube#membershipsLevelListResponse. |
etag |
etag
L'Etag di questa risorsa. |
items[] |
list
Un elenco di risorse membershipsLevel di proprietà del canale che ha autorizzato la richiesta API. |
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.
| Tipo di errore |
Dettagli errore |
Descrizione |
badRequest (400) |
channelMembershipsNotEnabled |
Gli abbonamenti al canale non sono attivi per il canale del creator che autorizza la richiesta. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-04-26 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-04-26 UTC."],[[["This API endpoint allows individual YouTube creators with channel memberships enabled to retrieve a list of their channel's membership levels."],["The API response will either include a list of membership levels, an empty list if memberships are enabled but no levels are set, or an error if memberships are not enabled."],["A successful request returns a JSON response containing the resource type, Etag, and a list of `membershipsLevel` resources."],["Requests to this method have a quota cost of 1 unit and require authorization with the scope `https://www.googleapis.com/auth/youtube.channel-memberships.creator`."],["The request requires the `part` parameter with a string value that can contain either `id`, `snippet`, or both, as comma separated values."]]],["This API endpoint allows individual creators to retrieve channel membership levels for their YouTube channel. A `GET` request requires authorization with the `youtube.channel-memberships.creator` scope and the `part` parameter to specify the properties. The response, in JSON format, lists membership levels or an empty list if levels are undefined. If channel memberships aren't enabled, the API returns a `channelMembershipsNotEnabled` error. This method has a quota cost of 1 unit per call.\n"]]
